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Methods and apparatus for making and using distributed applications. 



) A client-server system for which applications 
programmers may easily write services and in 
which a relationship between a server and a 
service may be changed without halting the 
server. Both client and server have access to 
copies of code for the service. The code has two 
parts : a caller portion which requests a service 
and a callee portion which executes the service. 
State variables in the dient process and the 
server process determine which portion of the 
code is executed. This mechanism permits a 
server to forward execution of the service to 
another server. The code for the service is 
written using a template which relieves the 
applications programmer of the need to write 
specialized code. The server provides the client 
with a server namespace which is distinct from 
the server's system namespace. The dient can 
locate a service by means of a service pathname 
in the system namespace. The server further 
provides the dient with namespace manipu- 
lation services which permit the dient to add 
services to and remove services from a server 
and otherwise to manipulate the server names- 
pace without halting the server. 
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1 Background of the Invention 
1.1 Field of the Invention 
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The invention concerns data processing systems generally and more particularly concerns techniques for mak- 
ing applications programs to be executed in distributed computing systems and executing such programs. 



1.2 Description of the Prior Art 



Modern computer systems are often distributed, that is. the system is made up of a number of computers which 
are connected by a network. Each computer is capable of operating independently, but many tasks require 
the cooperation of several computers. For example, in many such systems, a first process running on one of 
the computers executes a program which controls a large disk drive; when a second process on another of 
the computers executes a program which needs a copy of a file on the disk drive, the second process requests 
15 that the first process send it the copy via the network. 

One way in which processes running in a distributed system may cooperate is as clients and servers Ser- 
ver processes perform services for client processes. To have a service performed, the client process sends 
a message requesting the service to the server process; the server process then performs the service and 
returns a message with the result to the client process. Thus, in the above example, the second process is a 
file server process, the first process is a client of the file server process, and the service is providinq a coov 
of a file. 1 

A simple model for communications between dients and servers is the remote procedure call. In this mod- 
el. the client calls a service in the server in the same way in which it would call a procedure which it executes 
itself, that is, the client ceases executing the procedure from which it made the call, executes the called pro- 
cedure, and continues execution of the calling procedure on return from the call. In the same way. the process 
which makes the remote procedure call ceases executing the procedure which made the call. However, since 
the service is remote, the call turns into a message to the server. The server then executes the service spe- 
cified in the message and returns a message with the result to the client. When the client receives the message 
with the result, it resumes execution of the procedure which made the call. 

While the client-server model for cooperating processes and the remote procedure call are both widely 
accepted in the computer arts, it remains difficult for the ordinary applications programmer to write programs 
using the model. There are several sources for the difficulty. First, there are the complexities of communication. 
For example, the messages sent through the communications system often have representations of the data 
which are different from those used in the client and the server, consequently, data must be encoded and de- 
35 coded each time a message is sent. 

Second, there are the complexities of identifying the service remotely. The client and the server are dif- 
ferent processes, and they may be running on different computer systems. When this is the case, each process 
may have a different environment for names representing entities such as files. Such environments are termed 
herein namespaces. When the client and the server have different namespaces, the client must know the name 
-to for the service in the server's namespace. 

Third, there are the complexities of binding, that is, relating the name of a service to the code for the ser- 
vice. The binding may be done statically, that is. it cannot be changed once the object code for the server has 
been produced, or it may be done dynamically. In the second case, the binding may be done when the server 
begins execution or during execution. Binding during execution is the most complex kind of binding, but also 
*s the most useful, since it permits addition of services to and removal of services from a running server. It thereby 
becomes possible to maintain services in a server without shutting the server down. 

Fourth, there are the complexities of service location. In order to achieve a higher degree of fault tolerance 
or to balance system load, it is often useful to be able to have different servers execute the service for the 
client at different times. However, this needs to be a done in a way which requires no change in the way the 
50 client calls the service. 

These complexities of communications, naming, binding, and location have at least two unfortunate con- 
sequences: first, they leave the applications programmer with the the choices of making do with a set of pre- 
defined services which are provided by the operating system or undertaking the enormous effort required to 
wnte a dient-server system from scratch. Second, even if the applications programmer does undertake the 
55 required effort, the result is usable only on the systems for which it is written. What is required, and what the 
techniques disclosed herein provide, is a way of implementing services which is no more difficult than imple- 
menting an ordinary function and which produces reusable implementations. 
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2 Summary of the Invention 

The invention provides users of computer systems with techniques for implementing client-server systems 
which offer the following advantages: 
5 • it is as easy to implement a service as it is to implement a function in a standard programming language; 

• it is as easy for a client to specify a service in a server as it is for the client to specify a program in the 
client's own namespace; 

• the dient may add services to and delete them from the server and otherwise manipulate the server's 
namespace; 

io • services may be added to or removed from a server without interrupting operation of the server and 

• a server may either provide a service itself or forward the service to another server. 

Other objects and advantages of the apparatus and methods disdosed herein will be apparent to those 
of ordinary skill in the art upon perusal of the following Drawing and Detailed Description, wherein: 

15 3 Brief Description of the Drawing 

FIG. 1 is a diagram of a system of dients and servers which employs the techniques disdosed herein; 
FIG. 2 shows code for a service; 
FIG. 3 shows how code for a service is produced; 
20 FIG. 4 shows how a service is called; 

-FIG. 5 shows how a service is forwarded; 

FIG. 6 shows predefined services provided by a server 

FIG. 7 shows a super server. 

FIG. 8 shows the data structure used to define a server's namespace; 
25 FIG. 9.shows how a server can be used to achieve fault tolerance; 

FIG. 10 shows details of a dient; 
FIG. 11 is a first detailed diagram of a server and 
FIG. 12 is a second detailed diagram of a server. 

Reference numbers in the Drawing have two parts: the two least-significant digits are the number of an 
30 item in a figure: the remaining digits are the number of the figure in which the item first appears. Thus, an item 
with the reference number 201 first appears in FIG. 2. 

4 Detailed Description of a Preferred Embodiment 

35 The following Detailed Description begins with an overview of a system in which a presently- preferred embodi- 
ment of the invention is employed, continues with an overview of the dient and server, then provides details 
of how services are implemented, of how a server namespace is implemented, and of how server namespace 
operations are implemented, and finally describes a number of applications of the preferred embodiment 

i 

JO 4.1 System Overview: FIG. 1 

FIG. 1 provides an overview of a preferred embodiment Distributed system 102 is made up of a number of 
computer systems 101(a,b.c,and d) are connected by communications system 105. Each computer system 101 
has a processor upon which one or more processes may be executed and a file system 103 in which files con- 

•*5 taining programs and data may be stored for use by the processes. When a process running on a system 101 
wishes to access a file in file system 103. it uses a name for the file in 101's system name space. There are 
four processes shown in FIG. 1 0. a dient process 1 07 and server processes 1 31 (a,b, and c) (henceforth, simply 
client 107 and server 131). In FIG. 10. the dients and servers are on separate systems 101. but a given system 
101 may indude both clients 107 and servers 131. a server may have many dients. and the server and its 

50 clients may be on the same or different systems. Further, one server process 131 may be a client process 
107 for another server process 131. 

Server 131(a) provides three services 116 named A, B. and C to dient 107; the services appear in FIG. 1 
as service A 116(1). service B 116(2). and service C 116(3). There is service code 117 corresponding to each 
service 1 1 6. Code 1 1 7( 1 ) for service A 1 1 6( 1 ) is located on file system 1 03(c); code 1 1 7(2) for service B 1 1 6(2) 

55 is located on file system 103(b); code 11 7(3) for service 116(3) is located on file system 103(d). Furthermore, 
file system 103(a) has a copy of the code for each of services 11 7(1. .3). As will be explained in more detail 
later, service code 117 indudes code to be executed by a caller (dient 107 or a server 131 operating as client 
107's agent) and a callee (the server 131 which actually performs the service). Client 107 is able to locate 
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ni h k • ymea " s of serverl 'st 118(a) in file system 103(a). Server list 11 8(a) has an entry for each server 
1 31 wh,ch ,s access.b.e to client 107. The entry includes the name of the server 131 and the name of a system 

^ZT ? ",«? n nQ - Si0Ce lhS SySt6m " ame iS Part of the system na ™ s P a « of computer system 101. 
and he « r£7ii 1 ™i *! inf0rmati0n ** **" * ^""-cations between dient 107 

11 31 r, W ' be , eXp,a ' ned in more de,ail be,0 <* 131 are also accessible from other ser- 

^M^^T 39 "' -131contain S aserver,ist118which,iststheservers131ac. 

1 33 ^7Iiril?/ ideS 3 ^ namespace 1 33 10 ^"t107 and toother servers131.Servernamespace 

Server ^J^^^ 9 " 6 131(a) Pr0Vides to dient 107 « to a " 0,h « server 131. 

Server 1 31(a) can e,ther prov.de the service 116 itself or forward the client 107's request for the service 116 

namespace 133 establishes a correspondence between the name of the service and a copy of code 117 for 

* «T? m J° 1(C) - " an0,hef SerVer " Say 131(b >' provides ™*» s-ver name- 
pace 133 for server 131 (a) add,t.onal.y establishes a correspondence between the name of the service 116 
and t s name m the namespace 133 for server 131(b). In FIG. 1. service 116(1) has the name A. service 4(2 
has the name 8. and serv,ce 116(3) has the name C. In a preferred embodiment, server 131(a) organizes the 
cTJlT er na T PaCe 133 int ° 3 hierarChy 109 ° f " ameS - With ' r renting the root of hierarchy 109 
the flowing ' SerV,Ce " Pr ° Vide<1 ^ S6rVer 131(3) by meanS °' 3 S6rViCe P3thname which has 

<computer_system_name>/<server_nameW<service name> 
di J inr ll SerVer 'i St 118(a) i " d « :ates ,hat ^ver 131(a) has the name dcs and is on the system called condor, 
client 107 can spec.fy serv.ce A by means of the service pathname /condor/dcs/A. Similarly, the other servers 
llll !Z I?'" 6 ' " ameSpaces 1 33 < not shown in F,G - 1 °> to the clients and servers to which they make ser- 

c J"ii7 P To?7h d emb0dim ^ t 'f 1 > ; ent 107 executes a service 116 by executing the callee portion of service 
code 117 for the serv.ce 116. That portion of service code 117 117 contains a ServiceCall <path_ptr> 

I2Z Z 1 T > Ca " S SerViC8 116 in S6rVer 131 ^ a) - The af 9 uments «* ». functionlre a 

I ZZ < £ » S ,? 9 Ch iS tHe SefViC8 Pathname 0f the service - a P° inter to a «* <* arguments, and 
abufferfor ^the result ofthe service call. ,fdient107 uses ServiceCall to indicate to server 131(a7that it wfehes 
to be provided w,th serv.ce 116 8, then the pathname pointed to by the first variable is /condor/dcs/B 

server'^? tl W reSU ' tS ' ^ t0 SyStem 10 K C > " hicn ^ifies 

serve 131(a) as its dest.nat.on and contains the name of service 116 B and the arguments. When server 

f thitrl S V k meSSaQe J J US6S SefViCe P3thname 10 ,00k up the service in se ™er namespace 133. 

? exe ~ tedbyserveM3 1( a )-servernamespace133 contains the informationserver131^ 
needs o execute the serv.ce: ,f ,t .s to be executed by another server 131. server namespace 133 contains a 

ZZTZTw* ^ S6rViCe Path " ame SefViCe *• S6rVer nameSpaCe 133 be,on 9 in 9 to the 

is JSZZZ h 31 !? ^ Pf0Vi ? SerViCe ' S6rVer 131 (3) S, ' mp,y eXeCUteS the portion of code 11 7 " hich 

exlln ofT I ^ r . retUrnS 3 meSS39e Wfth the resU,tS 10 dient 107 « wnicn completes 
execut,on of the part of code 117 wh.ch is to be executed in dient 107. If another server 131 is to provide the 

Zr^™ ^ SXeCUteS ^ P ° rti0n ° f C ° de 117 Which * 10 «» executed bv th. caile, but usTs the , ink 
pathname provided by server namespace 133 in ServiceCall along with the arguments which server 13 a) 
receded from d-en, : 107. .n the case of service 8. server namespace 133 indicates that the serviced 6 s S 
SSL* h 3 l (b) T SV m ^ 101(b) ' 80 ' he meSS39e Pf0duCed by ServiceCal1 is <° «rver 

to server 131(a). wh,ch ,n turn returns it to dient 107. As is apparent from the foregoing, the message produced 
by the ,nvocat IO n of Serv.ceCall in client 107 may be forwarded any number of times. 

4.2 Service Code 117: FIG. 2 

Sfi T£ ma d f ' in6d by S f ViCe C ° de 11 7: 38 indiC3,ed above - each dient 1 07 w "«h can request a ser- 
v-ce 116 has access to a copy of service code 117 forthe service 116: similarly, each server 131 which can 

SoTma 3 r SS t0 3 ^ ' dient 107 3nd SefW 131 are *° *™ systemToi t" 

!S < r TT C 1 Py SerV ' Ce C ° de 1 1 7> ,n 3 Pr6ferred embodim ent. service code 1 17 used by client 

1J 1 7 T ' tl^? C ° de eXeCUted bY dient 107 Which 081,8 the ^>vice116 implemented by service 

asw.llbedescnbedmmoredeta.lbelow.Oynamiclinking of service code 117permitsservices 116to be added 
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to or removed from server 131 without interruption of operation of server 131. in other embodiments, service 
code 117 used by dient 107 may aJso be dynamically linked. 

FIG. 2 shows details of service code 117; in a preferred embodiment it has 6 parts: 

• Argument converter 201 is code for encoding the arguments for the service 116 into a form suitable for 
5 use by communications system 105 and decoding the arguments as received from communications sys- 
tem 105 into a form suitable for use by client 107 or service 131; 

♦ Result converter 203 is code which does the same for the results of the execution of service 116. 

♦ Init 205 is code which is executed when service code 117 is installed in a server 131; 

• Function 207 is code for the function performed by the service 116 implemented in service code 117; 
ro it includes two subparts: 

- Caller code 210. which is executed by a client 107 or a server 131 which is calling a server 131; and 

- Callee code 213. which is executed by server 131 which actually provides the service. 
Converters 201 and 203 are necessary because the networks used in modern distributed systems typically 
represent data as a stream of bytes. Consequently, the arguments for the service 116 and the results from 

is the service 116 must be translated between the forms which are required in the systems in which service 116 
executes and the forms required by the network. In the preferred embodiment the code for argument converter 
201 . result converter 203. and init 205 is provided automatically when service code 1 1 7 is generated; the person 
writing service code 117 need only supply the code in function 207. 

Caller and callee code are written in a preferred embodiment as branches of an if statement The function 
?o used in the if statement lsCaller() 209. is a special function used to implement system 1 02. It returns one value 
if service code 11 7 is being executed by a caller and another if service code 117 is being executed by a callee 
In the case of execution by a client 107. the function always returns the caller value; in the case of a server 
131. the function returns the callee value unless the server is forwarding the service request in that case, it 

rahirne tha r^li&r wall »n 



25 



returns the caller value 
4.3 Writing Service Code 117: FIG. 3 

FIG. 3 shows how Service Code 117 is written in a preferred embodiment There are four steps: 
30 ♦ Specifying Service Interface 

The preferred embodiment employs an extension of a remote procedure language used in Sun computer 
systems to specify the service interface. The specification defines data structures of input arguments and 
output results in a C-like syntax. It also declares a service function with the syntax: 
35 -servicer type-specifier identifier "f type-specifiers ")■;■ 

where "service" is a keyword, the first 'type-specifier- specifies the type of the value returned by the service 
function, the "identifier- specifies the name of the function and the -type-specifiers' in parentheses specify 
trie types of the function's arguments. 

•to • Generating RPC Stub and a Service Template 

Service code 117 is written using a service compiler, called ServiceGen 303, which takes a service inter- 
face as input (i.e.. spec* 305. and generates three outputs: XDR routines (i.e.. the file xdr.c 307). which are 
argument converter 201 and result converter 203 in a preferred embodiment a template (i.e.. the file template. c 
309) which a programmer can edit to implement the service function; and an initial function (i.e.. the file initc 
311) which contains code used when the service code 117 is installed in a server 131. 

• Implementing the Service Function 

application programmers implement the service function by editing (313) template 309 to produce the code 
for the service function service.c 315. 

• Creating a Service Library 

Service code 1 1 7 is generated by compiling and linking service function 315. which becomes function 207. 
xdr routines 307. which become argument converter 201 and result converter 203. and initial function 311. 
which becomes init code 205. Switches on the compiler permit compilation of service code 117 in forms which 
permit its incorporation into the server or client program at link time, at system initialization time, and at run 
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time. 



It should be emphasized that only the steps of specifying the service interface and implementing the ser- 
vice function are actually carried out by the applications programmer the XDR routines 307. the template 309 
and the initial function are all provided automatically by ServiceGen 305. Consequently, the applications pro^ 
grammerneed only understand the service function being implemented in order to write service code 117 

In otherembodiments. there may be no template 309. Instead, the applications programmer provides code 
for service function 315 which includes the service specification 303 to ServiceGen 305. which then generates 
the XDR routines 307 and the init routine 311 and provides the service specification 303. the XDR routines 
307. and the init routine 311 to the compiler. 

4.4 Example of Implementing Service Code 117 

The following example will show how service implementation system 301 may be used to implement a service 
cpO which operates in server 131 and copies a source file accessible to server 131 to a destination file ac- 
cessible to the server. The service takes two arguments, a pathname for the source file and another pathname 
for the destination f,| e . The result returned by the cp() function is an integer, with the value 0 if the execution 
successes otherwise a system error number (e.g.. errno in UNIX). 
The service interface for cpQ is the following. 



struct InArguaeat 

{ 

char froa[l28]; 
char to [128]; 

>; 

(a). service int cp(InArguaent) ; 

The interface includes a declaration for the input argument, i.e.. Struct InArgument, and a declaration for the 
service function, i.e.. the line (a). 

onn ? erviceGen then automatically generates generates XDR routines 307. initial function 311, and template 
309 for tne service. Initial function 311 for the service cp() looks like: 
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bool.t XdrInArgument(); /* XDR Function for input: IaArguaent «/ 
bool.t XdrlntO; /* XDR Function for output: int •/ 

int init (pathname) 
char * pathname 

caddr.t cp(); /• service function */ 

int init (pathname) 
{ 

if (creatnode (pathname, SERVICE, cp, XdrlnArguaent . Xdrlnt)) 
return (0) ; 

else 

return (-1); 

} 



25 This function is invoked by server 131 when the service 116is linked by server 131. It calls a function, crea- 
tnode(). which puts the name cp into server namespace 133. As will be explained in more detail later, each 
name in namespace 133 is represented by a node, and creatnodeQ creates such nodes. The function takes 
five arguments: the part of the service pathname following the server name, the type (SERVICE. LINK, or DI- 
RECTORY) of the node, a function pointer to function code 207, a function pointer to argument converter 201 . 

jo and a function pointer to result converter 203. 
Template 309 for cp() looks like this: 



35 



40 



45 



50 



55 



7 



EP 0 625 750 A2 



int* cp(argp, objp) 

struct InArgument *argp; 
char *objp; 



{ 



10 



static int res; 



15 



20 



25 



if (IsCallerO) 
{ 

if (ServiceCalKobjp, argp, &res) ! -SUCCESS) 
return (NULL); 

else 

return (Ares) ; 



/* implement the service here*/ 
retura(£res) ; 



30 



35 



40 



As previously indicated, service function 207 includes two parts: caller code 210 and callee code 213. Each 
of the parts is a branch of an if statement, and as can be seen above, the value returned by the function IsCal- 
lerO indicates which branch is executed. The value returned by that function indicates whether service function 
207 is being invoked by a cafler-or callee and also determines whether caller code 210 or callee code 213 is 
executed. In the template, the code marked by • in the left margin is caller code 210; callee code 213 remains 
to be implemented at the point indicated by the comment, r implement the service here*/. Caller code 210 
contains ServiceCall function 210, which actually invokes the service 207 on a server 131. 

As can be-*seen from the above, the template makes implementing a service function 207 as easy as im- 
plementing any other function. The fully-implemented service function 207 looks like this (lines beginning with 

are the callee code 213 which has been added to the template): 
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iat« cp(argp, objp) 

struct InArguaent »argp; 
char *objp; 



{ 



static int res; 
iat rf d ; 
int vfd; 
iat length; 
char buf[l024]; 



20 it (IsCallerO) 

{ 

if (ServiceCall(objp, argp, ftres) !=SUCCESS) 
25 return (NULL); 

else 

return (£res); 

30 
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> 

if ((rfd = open(argp->froa, 0_RD0NLY)) < 0 || 

(vfd = open(argp->to, O.CREAT I O.WRONLY, 0600)) < 0) 

{ 

res = errno; 
return (4res); 

} 

while ((length » read(rfd, buf , 1024)) > 0)) 
writ* (wfd. buf, length); 

close(rfd); 
close(wfd); 
res = 0; 
return (Ares); 
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Service code 117 for service 11 6 is then created by compiling and linking the service function. XDR func- 
tions, and the initial function as previously described. 

4.5 Implementation of Client 107: FIG. 10 

As previously explained, both client 107 and server 131 have a copy of service code 117 and service function 
portion 207 of service code 117 has caller code which is executed by client 107. Client 107 in a preferred em- 
bod.rnent executes object code for an applications program which uses the service implemented by service 
code 1 1 7. Linked to the object code forthe applications program are service code 117. object code for the IsCal- 
ler() function 209. object code for the ServiceCall function, and object code for a system-provided remote pro- 
cedure call. FIG. 10 shows the relationships between the parts of service code 117 and the other components 
of dient 107. IsCaller 1005 is the object code for lsCaller() function 209: the value it returns is kept in state 
variable ME 1007. In client 107. ME 1007 always indicates a callee. ServiceCall 1016 is the object code for 
Serv.ceCall function 211; data used by ServiceCall 1016 includes Args 1003. the actual arguments specified 
in the invocation of ServiceCall 1016. Results 1004. a buffer which holds the results of the execution of the 
serv.ee 116. and server list 118. which contains server name 1013 for each server accessible to client 107 
and server location 1015 for the server. Server location 101 5 is a network address for the server in commu- 
n.cat.ons system 105. Remote procedure call 1017. finally, is the remote procedure call 1017provided by the 
operating system under which client 107 is executing. Remote procedure call 1017sends call messages 1019 
to servers 131 and receives return messages 1021 from those servers. IsCaller function 1005. ServiceCall 
funct.on 101 6. and remote procedure call 101 7 together make up caller stub 1023 of client 107. As will be seen 
in more detail below, servers 131 also have caller stubs 1023. 

Operation of client 107 is as follows: A program being executed by dient 107 invokes the service using 
the functton name and arguments specified in server interface specification 303; the result of the invocation 
is the execution of the code in service function 207. Since client 107 is executing service function 207 IsCaller 
mdeates that the caller is executing the service function, and the code in caller portion 210 is executed. That 

10 
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code contains an invocation 211 of ServiceCail 1016. The invocation specifies service pathname 116, which, 
as previously indicated, indudes the system 101 upon which server 131 executes, the name of server 131 and 
the pathname of service 116 in server 131s namespace, arguments 1003 for the service 116. and buffer 1004 
for the results of the execution of the service by the server. For example, if the system name is condor and 
the server name is dscs and the pathname in dscs's server namespace 133 /bin/cp. the service pathname 
will be /condor/dscs/bin/cp. 

Service call 1016 places the arguments for service 116 in Args 1003. uses the server name in the path- 
name to find the network address for the server in server list 118, and then invokes remote procedure call 1017. 
The invocation specifies as arguments the network address, the pathname for the service in the server name- 
space 1 33. arguments 1003. buffer 1004 for the result, argument converter 201 . and result converter 203. Re- 
mote procedure call 1017 uses argument converter 201 to put the arguments for service 116 into the proper 
form for the communications system, then makes a call message addressed to server 131 which contains the 
service path name and the encoded arguments, and finally sends the call message 1019 to server 131. 

When server 131 is done executing callee code 213. it sends a return message 1021 to RPC 1017 which 
contains the results. RPC 1017 uses result converter 203 to decode the results, places the decoded results 
in results buffer 1004, and returns to ServiceCail. which in turn returns to caller portion 210 of service function 
207. Execution of caller portion 210 is then completed. Typically, completion of execution of caller portion 210 
involves returning the contents of results buffer 1004 to the execution which invoked service function -207. 

4.6 Implementation of Server 131: FIG. 11 

Fig. 11 shows details of those parts of the implementation of server 1 31 which are directly involved in the exe- 
cution of a service 116. Server 131 has its own copy of service code 117 for the service 116 and additionally 
includes a caller stub 1023 with the same components as caller stub 1023 in client 107. Caller stub 1023 and 
the other components of server 131 which are directly involved in the execution of service 116 together make 
up callee stub 1103. The most important additional component of callee stub 1103 isdispatch 1105. object code 
for a function which responds to a call message 1019 from a dient 107 by executing service function 207 for 
the service 116 spedfied in the call message. 

Continuing with a more detailed description of the implementation of server 131. the call message 1019 
received in dispatch 1105 specifies the service pathname in server namespace 133 of service code 117. dis- 
patch 1105 invokes a function. FindService. in server namespace 133, which takes the service pathname 1117 
for the service and returns information 1119 specifying where the service is to be provided. Next, dispatch 
1105 invokes decode function 1109. which takes the message and a pointer to argument converter 203 and 
decodes the arguments in the message and places them in Args 1115. Thereupon. dispatch1105 determines 
whether information 119 spedfies that the service is to be provided by server 13.1 or another server 13V. In 
the latter case, the information indudes a link pathname for the service which specifies the service pathname 
for the service 1 1 6 in server namespace 1 33 f belonging to server 1 31 \ When the service 1 1 6 is to be provided 
by server 131. dispatch 1105 sets state variable ME 1111 to specify a callee; otherwise dispatch 1105 sets 
state variable ME 111 to specify a caller. Thereupon, dispatch 1105 invokes service function 207 with the ar- 
guments in Args 1115 and a service pathname, as shown by arrow 1121. If the service 116 is to be provided 
in server 131. the service pathname is the pathname for the service 116 in server 131 's server namespace 
1 33; if it is to be provided in server 1 3 1 \ it is the pathname for the service 1 1 6 in server 1 31 "s server namespace 
133'. 

As described in the discussion of dient 107. whether caller portion 210 or callee portion 213 of service 
function 207 is executed depends on the value returned by IsCaller 1005 of caller stub 1023. which in turn 
depends of the value of ME 1111. Thus, if service location 1119 spedfies a location on another server 13V, 
dispatch 1105 has set ME 1111 to indicate a caller, and caller portion 210 is executed with service location 
1119 and arguments 1115 as arguments for ServiceCail 1016. The invocation of ServiceCaJI1016 proceeds 
exactly as described for client 107. except that the results which ServiceCail 1016 receives from RPC 1017 
are placed in results buffer 1113 and that the function which resumes execution on return from caller portion 
210 is dispatch 1105. as shown by arrow 1123. 

If information 1119 spedfies that server 131 is to provide the service 116. dispatch 1105 has set ME 1111 
to indicate a callee. IsCaller so indicates, and callee portion 213, which contains the code which performs the 
actual function for the service, is executed using the contents of Args 113. The result of the execution is placed 
in Results 1113. and the return is to dispatch 1105. Regardless of whether caller portion 210 or callee portion 
213 was executed, dispatch 1105 uses results converter 205 to encode results 113 and sends the encoded 
results in a return message 1021 to the source of the remote procedure call, which may be a dient 107 or an- 
other server 131. 
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4.7 Calling and Forwarding a Service 116: FIGS, 4 and 5 

FIGS 4 and 5 show how client 107 and server 131 cooperate to execute a service 116 for a user program 

exe^ I 4 ^ h 131 SpeCified in dien < ^ ^ er list 

in d e 107 SiT 1166 T 213 ' C, | ent 107 S6fVer 131 h3Ve du > licate C °P ies code 117; 

m clrent 107, IsCaller always returns a value indicating that service code 117 is being executed by a caller 

Thus when user program 401 invokes service function 207 in service code 117, caller portion 210 of service 

So a ca m "^tT ** °' 211 ™*« *ub 

ducmg a call message 1019 to server 131. 

whether r"^?- T iVed bY Ca " ee StUb 11 ° 3 - Ca " ee StUb 1103 determines from server namespace 133 
whether server 131 e to execute service 116. In the case of FIG. 4. server 131 is to execute the service and 
consequently caned stub 1103 sets ME variable 1111 to indicate 'callee". Then cal.ee stub 1 03 nvoTes ser 
s^nrf f, lsCa " er j ndica,es this time »* -"vie. function 207 is being executed by a cLezntcl 

03 re .T POrt '° n 'V XeCUted - Whe " ** eXeCUti0 " °' ral,ee P° rti0 " 213 * "^hed. caltee stub 
1 03 returns return message 1221 to caller stub 1023. which executes any remaining part of caller portion 

?22n™ 

In the case of FIG. 5. there are two servers, server 131(i). which is the server listed in client 1 07's server 

^S? 1ffl : * "' Sted i0 S6rVer 13WS S6rVer " ames P ace 133 as <"« server upon wch 
IcrtlSZ ° f r rV,C \ 207 ,S to be executed - Clie "< ™ produces call message 1019 as previously de- 

6 itlr^Zn • 6 StUb , 11 ° 3 " SefVer 131(0 detemiineS fr ° m Server names P ace 133 «S« for servict 
116.server131(0 l sanagentforserver1310).thatis.that S ervice116istobeexe^tedby S erver1310) Co" 
sequen ly cal.ee stub 1103 sets ME variable 1111 to indicate 'caHer- and when callee stub 1103 executis ser- 
ve 131 (,)s copy of serv.ee code 117. IsCaller indicates "cailer- and ft is ca..er portion 210 of service code 117 

2 i t 1 C ?' ee StUb 1103 indUdeS ' eBlhr Stub 1023 and a servi " «■* 1«. when ServiceCal. 

LvlVAin ^ POrt, ° n 210> ^ reSU,t iS 3 0311 meSSa 9 e 1019 «" service "« to server 1310. Since 

server 1310) s server namespace 133 indicates that server 1310) is toexecute service 116 server 131(1) exe- 
cutes callee por.cn 213 as described above; server 131Q) then 'returns return message 1023 lo slr^e ST 
which executes the remamder of caller portion 210. That in turn results in callee stub 1103 of server 131(1) 

Z o^™, SiT? C "' ent 107< Whfeh tUr " Pr ° videS the returned ™«* to »• ^~tion o 

user program 401 wh.ch .nvoked serv,ce 116. Of course, server 131(j) may also be an agent in which case 

he 6 P r i0n ?V f ° rWarded * y6t an ° ther — 131 k >- There is i" generarno I mi o 

the length of the chain of agents: however, in a preferred embodiment the call message from client 107 in- 

o r aV f :*:z ; T th , e number of ,imes the execution ca * be f °- arded - ^ • Z « 

for a service 116 from being forwarded around a loop of serversfi31. x 
4.8 Implementation of Server Namespace 133: FIG. 12 } J 

FIG. 12 presents an overview of the implementation of server namespace 133 for a server 1 31 in a preferred 
embodiment. Server namespace 133 maps service pathnames onto location information 1119 for services 

2 TJ»? w P ° S f ki0dS ° f ' pCa,i0n infofination - ,f lhe service 11 6 is to be provided by the server 131 ! 
the locafon information may either be a pointer to a copy of service code 117 in the memory of system 101 
upon which server 131 is running or the system path name of a fi.e containing service code 117 in f^esys em 

is the serv.ee path name of service 116 ,n thatserver 131"s server namespace 133'. Consequently as shown 
by the arrow .abe.led 1117.1119. dispatch 1105 in cai.ee stub 1103 can use server namespace 33 to"so.ve 
service path names 1117 into service location information 1119 

h Jn^TnST " ?■ SCrVer nameSpaCe 133 include hierarchv representation 1212. which represents the 
hierarchy of names makmg up server namespace 133. namespace primitives 1203. which operate on hierarchy 

sisr^ 1 which perfonTis ,he mappin9 between service c ° de 117 in disk <^e y 

1 03 and the names spec.f-ed m h.erarchy representation 121 2. and namespace services 1201 which is a set 
s acl V ; C 33 1 T 1 h 6 a WhiChServer 131 Pf0vides 10 its ™ so that the clients 107 can manipulateSver namt 
1^1202. ** nameSpaC8 Pnmitives 1203 t0 P erform the a «»* manipulations, as shown by 

4.8.1 Hierarchy Representation 1212: FIGS. 12 and 8 

Continuing in more detail with hierarchy representation 1212. representation 1212 is a tree with three kinds 
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of nodes 1206: directory nodes 1207, which represent directories in server namespace 133. service nodes 
1209, which represent services 116 which are executed by this server 131. and agent nodes 1211. which rep- 
resent services 116 which are executed by other servers 131 for this server 131. FIG. 3 shows how nodes 
1206 are implemented: each node has two parts: a node structure 801. which represents the node itself, and 
context structure 803. which represents either the directory or the service 116 represented by node 1206. FIG. 
8 also has a detail of node structure 801; it contains name 804. which is the name in server namespace 133 
represented by node 1206. attributes 833. which indicates attributes of the node, parent pointer 807. which 
points to the parent of node 1206 in hierarchy representation 1212, and cont_ptr 809. which points to context 
structure 803 for the node. 

The attributes indude the node 1206's type in field 805. and in the case of service nodes 1209, they also 
include mapped bit field 835. which indicates whether the service node is mapped to a file containing service 
code 117. and if the node is not mapped, file attributes for service code 117. The file attributes include the 
last time service code 117 was accessed by server 131. in field 837. the time the file containing service code 
1 1 7 was created, in field 839, and an access control list in field 841 . The access control list is a list of the users 
allowed to access the service. 

The contents of a context structure 803 for a service are shown at 811. The first three fields are set when 
service code 117 is loaded into the memory of system 101 upon which server 131 is running, func _ptr 813 is 
a pointer to function code 207 for the service; in_dec_ptr 815 is a pointer to argument converter 201 and 
out_dec_ptr is a pointer to result converter 203. SL path 819 is the system path name of service code 117 in 
file system 103. The system path name is used by service linker 1205 to locate service code 117 in file system 
103. SLJiandle 821 is the value returned by file system 103 when service linker 1205 opens service code 
117. Linkjnfo 823. finally is used when node 1206 represents an agent 1211. In that case. Linkjnfo 823 con- 
tains a service path name for service 116 in server 13V which is to provide the service 116. 

The contents of a context structure 803 for a directory are shown at 825. The first field, map_path 827. 
is used to map a directory name in server namespace 133 to a directory name in file system 103. When this 
has been done, server 131 automatically adds services 116 with service code 117 in the mapped directory to 
its server namespace 133. The field contains the system path name in file system 103 of the directory which 
corresponds to the directory in server namespace 133 to which context structure 803 belongs. The remainder 
of the fields in context structure 827 are pointers to the nodes 1206 which represent the services or directories 
in the directory represented by dir_struc 825. There is a node_ptr 831 for each service or directory, and the 
list of pointers makes up node_ptr_list 829. 

4.8.2 Details of Namespace Primitives 1203 

The primitive operations in server namespace 133 fall into two classes: locating a node 1206 when given the 
path name for the entity represented by the node and adding and removing nodes 1206 in hierarchy represen- 
tation 1212. 

The primitive for locating a node is namei. nameitakes a pathname in server namespace 133 as as an 
argument and returns a pointer to node 1206 which represents the pathname. The function begins at the root 
of hierarchy representation 1212 and works down the pathname and hierarchy representation 1212 a compo- 
nent at a time, if namei either runs out of names in the pathname or runs out of nodes in representation 1212, 
or finds a service node 1209 or an agent node 1211, it returns the pointer to the current node 1206 and any 
remainder of the pathname. 

The primitive which adds a node is called creatnode. Its arguments include the type of the node and in- 
formation required to fill in the relevant fields of node structure 801 and context structure 803. The primitive 
creates a node structure 801. fills in fields 804. 833. and 807. creates the proper type of context structure 
303. fills in fields of the context structure as required by the node type, and fills in field 809 of node structure 
801. The primitive which removes a node simply unlinks node structure 801 from hierarchical representation 
1212, updating node_pt Mist 829 in the parent of the removed node 1206 as required. 

4.8.3 Using the Primitives 

The primitives are used to execute a service 1 16 and to perform namespace services 1201. As previously de- 
scribed, executing a service is carried out in server 131 by dispatch1105. a component of caJlee stub 1103. 
dispatch receives a message with a service's path in name space 133 and uses the function FindService to 
find the service. FindService uses namei to move down hierarchical representation 1212 until it reaches a leaf 
node. 

What happens then depends on the node type. If the leaf node is a service node 1206 or a an agent node 
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1211 FmdService simply returns the node to dispatch. If the node is a directory node and has a map path 
827 F,ndServ,ce passes the remainder of the pathname to a function called DLService. which used map path 
827 to find a directory in file system 103 and then uses the rest of the path name to locate service code 117 
banning at that directory. Once DLService finds service code 1 1 7. it executes the service codecs init function 
ZI tL" tUr " eXeCUteS crealnode t0 create the necessary nodes in hierarchy representation 1212 for ser- 
vice 116. Thereupon, it returns the service node 1209 for the service 116 to dispatch. In all other cases Find- 
Servtce returns a value which indicates failure. 

, !! ?on! e ^! e indiCateS fai ' Ure ' diSpatCh Se " dS 3 messa 9 e t0 the ««erindicating that the service was not 

, 0 fl°iT,t ho h ?™ ? ' , P3tCh bS9inS Pr ° Vidin9 S6rviCe 116 - First il uses in - dec -P tr 81 5 ! " services true 
ro 811 for the node 1206 to locate argument converter 201 in service code 117 and decode the argument fo~r the 
serv.ee What dispatch then does depends on the contents of node 1206; if node 1206 is an agent node 1211 

d ,' SP ? C ^ S nI S ^ 1 11 '° indiC3te Ca "* f 3nd SetS the hand,e for tne service to be <*»* d fro«" 'ink info field 823* 
f node 1206 .s a serv.ee node 1209. dispatch1105 sets me 111 to indicate callee. In both cases, dispatch 1105 

,s l^^HK " h Ptr I , !! ° ke ' U " Cti0n 2 ° 7 - Whe ° the ,UnCti0n ' 8 ma PP ed bit 835 is '"vocation is 

P«ceded by a check of the access control list of service code 117; otherwise, the check is made on access 
control list 841 in node structure 801 for the service 116. On return from the invocation, dispatch 1105 uses 
out.decjtr to locate result converter 203 in service code 11 7 and encode the results of the execution of the 
service. The encoded result is then returned to the caller. 

The namespace primitives are also used by namespace services 1 201. FIG. 6 is a list of those services 

20 in a preferred embodiment. With the exception of null 621 . each of the services 602 either reads or alters a 
node 1206. In a preferred embodiment, directory nodes 1207 are added by mkdir service 671. mkdir 671 takes 
the pathname in name space 133 of the new directory as an argument After name! has located the already 
existing part of the pathname, creatnode simply makes node structure 801 and dir.struc 825 for the new di- 

,< te T^l\ S th V i6,dS I" "° de StrUCtUfe 801 38 required for the new director y- and * Poster to the new 

1 i de - ptrJ ^ 

the pathname of the node to be removed as an argument At the time of the removal, the directory node 1207 
may not have any children. The remove primitive simply unlinks the specified node 1207 and updates 
node_ptr_list 829 in the parent node of the deleted node accordingly. 

The mkservice service 605 adds a service node 1209 to hierarchy representation 1212. The arguments 
30 for mkservice are the service pathname of the new service in server namespace 133 and the system pathname 
of the U\e containing service code 117 in file system 103. mkservice uses namei to locate the directory node 
207 which is the parent of service node 1 209 for the service 1 1 6 to be added. Once the proper directory node 
1 207 has been located, mkservice uses the dlopen primitive provided by service linker 1 205 to open service 
code 117 and uses-another primitive, dlsym. provided by service linker 1205. to execute init portion 205 of ser- 
VIC « ~^ 11 7 wjth the arguments of mkservice. Init portion 205 in turn uses creatnode to create the new node 
and f.ll ,n f.ekls 804-809 .n node structure 801 and service.struc 811. Aservice node 1209 is removed by the 
rmserv.ee 607 service, which employs the removal primitive substantially as set forth above for directories 

The syml.nk service 609 changes a service node 1209 to an agent node 1 211 . The arguments are the ser- 
v '«P*hname of theses 

« o he serv.ee 116 .n the server namespace 133 of the new server 133'. symlink uses the service pathname 
of the serv.ee in the present server with namei to obtain a pointer to the service node 1209 and then changes 

,V yP f. ? ^ S , ef , V j C a a "° de 1209 10 UNK and p,aces tne se ' vice °< the service in the new server 

133 ,n link mfo field 823 of service.struc 811. The unsymlink service 611 changes an agent node 1211 back 
into a serv.ee node. The service takes as its argument the pathname for the agent node 1211 in server 133 
« It uses namei to locate the node and then resets the node's type to SERVICE 

The bind and map services 61 3 and 61 5 establish relationships between nodes 1206 and parts of the sys- 
tem name spaceof system 101 upon which server 131 runs, bind 61 3 takes as its argument a service pathname 
in server namespace 133. It 613 uses namei and the service pathname to locate the node 1209for the service 
It then sets mapped bit 835 to indicate that the service 1 16 has been bound to the file containing service code 
so 117. Mapped bit 835 can be reset by setstat as described below. 

The map service 615 maps a directory node 1207 in .-.ierarchy representation 1212 onto a directory in file 
system 103. The arguments for map are the service pathname for directory node 1207 and the system path- 
name for the directory in file system 103 which is to be bound to directory node 1207. The service uses namei 
to locate the directory node 1 207 and then writes the system pathname for the directory in file system 103 
« into mapjjath field 827. 1 

The stat and dir namespace services 602 return information about a service 116 or a directory stat 602 
returns the attributes of service 1 1 6. dir returns a list of the contents of a directory in server namespace 1 33 
Both services take a service pathname as an argument. Both use namei and the service pathname to locate 
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the node 1206 specified by the service pathname, and the information returned by the services is then ob- 
tained from the sped f ied node. In the case of stat the information is always the node's type 805 and the setting 
of its mapped bit field 835 from node structure 801. If mapped bit field 835 indicates no mapping, the infor- 
mation further includes the contents of access time field 837, create time field 839, and access control list 
field 841. If mapped bit field 835 indicates mapping, this information is obtained from the file which contains 
service code 117. setstat623 permits mapped bit field 835 and the contents of fields 837-841 to be set by a 
client 107. The arguments are the service path name for the node and the values to which the attributes are 
to be set. The function uses namei to locate the node 1206 and then sets the relevant fields from the values. 

getservice 625 and putservice 627 permit service code 117 to be uploaded from a dient 107 to a server 
131 and downloaded from a server 131 to a dient 107. Uploading is done by putservice 627. which takes as 
its arguments a service path name for the service 116 and a bufferwith service code 117. Server 131 performs 
the function by creating a file in its file system for service code 117 and creating a service node 1206 for the 
service 116 which specifies the file containing the uploaded service code 117. Downloading is done by get- 
service 625. which takes two arguments: the service path name for the service 116 and a buffer for service 
code 117. In server 131 . getservice uses namei to locate service node 1209 for the service 116, uses the in- 
formation in service node 1209 to locate service code 117, and sends service code 117 back to dient 107. In 
client 107, the service code is moved from the buffer to a location in the system name space of dient 107 and 
is then dynamically linked to the code being executed by client 107. 

4.9 Applications of Servers 131: FIGS. 7 and 9 

Servers 131 may be used in a number of ways to solve problems of distributed systems. One such problem 
is fault tolerance. As shown in system 901 of FIG. 9. A server 131(a) can forward a request for a service to 
any of a number of servers 131(b..n). Consequently, server 131(a) can respond to a failure by one of the ser- 
vers 131(b..n) by using symlink 609 to change the agent node 1211 for the service so that the the request for 
the service is forwarded to a working server 131. 

Forwarding requests for services can also be used to balance loads among servers 131(b..n). Server 
1 31(a) need only keep track of how many requests have been forwarded to each of the servers 131(b..n) and 
change the agent node 1211 as required. Such load balandng may of course also be responsive to other in- 
formation such as the state of the systems in which servers 1 31 (b..n) operate or the time of day. In some em- 
bodiments, link info 823 can be a pointer to a scheduling function which determines which of the servers 
1 31(b..n) the service request is to be forwarded to. 

The fact that a service 116 is accessed by means of server namespace 133 also makes dynamic updating 
of services easy. All that need be done when a new copy of service code 117 for a service 116 becomes avail- 
able is use rmservice 605 to remove the old service 116 from server namespace 133 and then use either 
mkservice or putservice 627 to again place service 116 in server namespace 133. mkservice is used when 
client 107 and server 1 31 share a system name space and putservice is used when dient 107 and server 131 
belong to different system name spaces. Access by a dient 1 07 to a service node 1 209 which is being changed 
can be avoided by the use of one many locking mechanisms. 

One way of taking full advantage of the possibilities opened up by servers 131 and services 116 is to in- 
clude a super server in the distributed system FIG. 7 shows a distributed system 701 with a super server 703. 
Like an ordinary server 131. super server 703 has a file system 103(a) with service code 11 7(a..n) for a number 
of services. Super server 703 of course also has a server namespace 133 with nodes 1206 for the services. 
The difference between super server 703 and a server 131 is that super server 703 distributes services 116 
as well as executing them. 

One way in which such a super server 703 can be used is to distribute services 116 to dients 107. To re- 
ceive a service 116, the dient simply uses getservice 625 to get its copy of service code 117 for the service. 
Another way in which such a super server can be used is to distribute services 1 1 6 to other servers 131. When 
super server 703 is being used this way. it responds to a request by dient 107 to execute a service 116 (j) 
whose code is induded in code 117(a..n) by downloading code 1170) for the service 116 to a server 131(i) of 
servers 131 (0..m) (arrow 709) and setting server namespace 133 in super server 703 so that requests for 
service 116(j) are forwarded to server 131(i). The downloading is of course done using putservice 627. 

In another embodiment, super server 703 responds to a request for dient 1 07 for mkservice 605 for a ser- 
vice 116(i) by downloading service code 117(i) for service 116(i) to a server 131(k) in servers 131(0..m) and 
returning a handle 707 for service 116(i) in server 131(k) to dient 107. The handle is of course the name of 
server 131(k) and the pathname of service 1 16(i) in server 1 31(k)'s name space. Client 107 can then use handle 
707 to directly request server 131(k) to execute service 116(i). Super server 703's choice of a server 131(k) 
can of course be made from the point of view of load balancing. Similarly, if server 1 31 (k) fails, dient 1 07 need 
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only repeat the mkservice request to get a new server 131. 

te . eD °h^ ( f? a > in H WhiCh d t ientS T ;° 7 - Sefvers 131 ' and se " ices ™ can be used to particular advantage is the 

ttf m th " " 9 SY / 6 m ° dem te ' ePh0ne SWitChin9 SyStem indudes a laroe ^tributed computing 
system. The components of the switching system often function as clients and servers for each other. For ex- 
ample, when a call using an 800 number is made, the switching system must get the actual telephone number 
which currently corresponds to the 800 number from a data base. The switch which receives the 800 number 
'saci,entof the data base, which isaserverfor the 800 number. A number of properties of clients 107. servers 
1, I iiT'"! 116 are P articular| y use ™ i" «« telephone switching system. There is first the fact that a 
11 \Z% \\ T m h ay added k to , 0r removed from a serve ' «1's name space without interrupting operation of 
server 1 31 ; Then there ,s the fact that the system provides a number of techniques for load Muring among 

coZVT:T T f ^ 0< re ' ati0nShiP b6,Ween 3 SefVice 116 and < he fi,e *y«™ containing^™ e 

s: 11 . 7 ^ «tt s r 0 r s 116 may be easi,y propa9ated ,rom serveM31 * — 131 - b - 

the ZlT^^Tl m ' SerVefS 131, 3nd SerViCeS 116 m * ht be used in a system is 

the following, client 107 m.ght be a programmable device such as an answering machine- server 131 mioht 

the service 1 6 m.ght permit the answenng machine to request the number of the party whose call is being 

TZTJl^rZT? maChine fr ° m SWitCh - ^ ° Wner ° f the ans - ri "9 couW cal. an 80? 

number and specfy that the service be provided to the answering machine at a given telephone number The 

mSnT TT 'VrT? ^ CaUSin9 ^ 131 10 d0W1,0ad "J"** 1 6 1 the answer g 
mach.ne, which would then be able to perform the interaction defined by the service. 

5 Conclusion 

a J^!!!^!^^?^ * th0Se ° f ski " in the art ho " to make and use 

l£2'n TJ ' T : e "l b0d,eS the Prindp,eS ° f the inventions daimed herein - w hile the Detailed De- 

° f imp,ementin S ^ P"ncipies present.y known to the inventor, other inv 
SS^^Tf PnBC, . Pta " am i . po, ! rt,, «- F«««l.nc^ In oteiniplmnMloM. eommuRie«tion. bst^n 
22rS y ' meChaniSms otner tnan remote P^^e call. Similarly, in other implemen- 

m ?„; t nameSPaC8 ^ be ,,3t i0Stead °' nierarcnical - 1" other implementations, the service code 

may notmdudetheargumentandresultconvertersorthe initialization code. Further, there may be applications 
where services are dynamically linked to clients or statically linked to servers. 



Claims 



1 . Apparatus for dividing execution of a program (117) between a caller process and a callee process running 
in a computer system, the apparatus being characterized by: 

nr QC .« tr?}T 5) dete ™"*i°n whether a process (107) executing the program is a caller 

process or a callee process; and . 

in the program, 

a caller portion (210) 

a callee portion (213). and 

a selecting portion (209) for selecting either the caller portion or the callee portion for execution 
by the process according to the determination. 

2. The apparatus set forth in daim 1 further characterized by: 

another process (131(a)); 

Mmo. meanS ^T 5 "! to eXeCUtl ° n ° f the Ca,ler P0rti0n b * the P racess < 107 > for ending a message 
(1019) requesting that the other process execute the program- 

thereto, and commencing execution of the selecting portion of the program 

whereby the other process is able to execute the program as either a caller process or a callee process. 

3. The apparatus set forth in daim 2 further characterized in that 

the other process has access to namespace (133) means for relating a first name identifying the 
program to a location of a copy of the program; and 

the program further includes an initialization portion (205) which is executed by the other process 
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in order to install the program in the namespace. 

The apparatus set forth in daim 2 further characterized by: 

a further process (131(b)). the further process having message receiving means like those in the 
other process: 

and wherein 

the other process has means (1023) responsive to the cailer portion for sending a message (1019) 
to the further process requesting that the further process execute the program: and 

the means for receiving the message determines whether the callee portion is to be executed by 
the other process or the further process and causes the determination to indicate a callee process in the 
first case and a caller process in the second case. 

The apparatus set forth in daim 4 further characterized by: 

namespace means (133) accessible to the other process for relating a first name identifying the 
program either to a location of a copy of the program or to a second name identifying the further process: 
and 

the means for receiving the message determines whether the called portion is to be executed by 
the other process or the further process in response to the namespace means. 

The apparatus set forth in daim 2 further characterized in that 

the apparatus is implemented in a distributed computing system induding a plurality of processing 
nodes (101): 

the process and the other process execute on different ones of the nodes: and 
the means for sending a message sends the message from the node upon which the process is 
executing to the node upon which the other process is executing. 

The apparatus set forth in any of claims 2, 4, or 5 further characterized in that 

the means responsive to execution of the caller portion indudes means (1 023) for receiving a return 

message from the other process with results of execution of the program; and 

the means for receiving the message indudes means (1016) for sending the return message with 

the results to the process. 

The apparatus set forth in daim 7 further characterized in that 

the means for sending a message, the means for receiving a message, the means for sending a 
result message, and the means for receiving a return message are provided by remote procedure call 
means (1017). 

The apparatus set forth in daim 7 further characterized in that 

the message and the return message employ a first representation of the data which is different 
from a second representation of the data employed in the computer system; 

the message indudes an argument value; 

the return message returns a result value; 

the program further indudes 

an argument converter portion (201) and 

a result converter portion (203); 

the means for sending a message and the means for receiving a message use the argument con- 
verter portion to convert argument values between the first representation and the second representation; 
and 

the means for sending a return message and the means for receiving the return message use the 
result converter portion to convert result values between the first representation and the second repre- 
sentation. 

A client-server system of the type wherein a server process (131) executing in a computer system provides 
a service for a client process (107), the dient-server system being characterized by: 

server name space means (133) employed by the server process to relate a name for the service 
to means (117) for providing the service, the name being part of a server namespace distinct from any 
system namespace provided to the server process by the computer system. 

service calling means (1016) employed by the dient process to send a message to the server which 
indudes the name for the service; and 
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service dispatching means (1105) employed by the server process for responding to the name for 
the service in the message by employing the server name space means to locate the means for providing 
the service and thereupon to employ the means for providing the service to provide the service to the 
dient. 

5 

11. The client-server system set forth in claim 10 further characterized by: 

one or more namespace manipulation services (1201) which the server process provides to the 
client process and which the client process employs to manipulate the server namespace. 

w 12. The client-server system set forth in claim 11 further characterized by: 

a make service service (605) of the namespace manipulation services which relates a new name 
in the server namespace to means for providing a new service. 
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\ A dient-server system for which applications 
programmers may easily write services and in 
which a relationship between a server and a 
service may be changed without halting the 
server. Both client and server have access to 
copies of code for the service. The code has two 
parts : a caller portion which requests a service 
and a callee portion which executes the service. 
State variables in the dient process and the 
server process determine which portion of the 
code is executed. This mechanism permits a 
server to forward execution of the service to 
another server. The code for the service is 
written using a template which relieves the 
applications programmer of the need to write 
spedalized code. The server provides the dient 
with a server namespace which is distinct from 
the server's system namespace. The dient can 
locate a service by means of a service pathname 
in the system namespace. The server further 
provides the dient with namespace manipu- 
lation services which permit the dient to add 
services to and remove services from a server 
and otherwise to manipulate the server names- 
pace without halting the server. 
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